feat: today 대시보드 - 7일 이내 만료 요약 - #115

왜 필요한가요?

Refs #15

#15의 완료조건 "향후 7일의 체류·계약·서류 만료 요약"을 구현합니다.
GET /dashboard/today에 이어서 upcoming_7_days 필드를 추가합니다.

완료된 범위

• UpcomingExpiryCategory(STAY_EXPIRY/CONTRACT_END/EMPLOYMENT_PERMIT_END/
  EMPLOYMENT_ACTIVITY_END/DOCUMENT_EXPIRY), UpcomingExpiryItemResponse DTO
• DashboardQueryService: Worker 4개 날짜([Worker][P0] E-9 업무용 4개 날짜·비자정보 확장 #84) + WorkerDocument 만료([Document] 통합 문서함·파일 업로드·문서 준비도 구현 #13)
  조회 로직
• DashboardTodayResponse에 upcoming_7_days 필드 추가

결정 사항 및 발견한 버그 (실제 서버로 검증하며 발견)

• 경계값 버그: 기존 WorkerSearchQuery/WorkerDocumentSearchQuery의
  expiryBefore 필터가 <(미만)만 지원해, "정확히 7일 후"인 항목이
  누락되고 있었습니다. windowEnd를 targetDate+8로 조정해 해결했습니다
  (기존 필터 API의 의미는 그대로 유지).
• 과거 날짜 포함 버그: expiryBefore 필터에 하한선이 없어, 이미 지난
  만료일(예: 3주 전 만료)까지 포함되고 있었습니다.
  WorkerSearchQuery/WorkerDocumentSearchQuery에 expiryAfter 필터를
  새로 추가하지 않고, DashboardQueryService에서 애플리케이션 레벨로
  targetDate 이후만 걸러내도록 했습니다.
• 두 버그 모두 로컬에서 실제 Demo Seed 데이터로 서버를 띄워
  GET /dashboard/today를 직접 호출해보며 발견했습니다.

어떻게 검증했나요?

• ./gradlew clean test — 전체 통과
• upcoming7DaysIncludesWorkerWithNearExpiry — 임박 포함
• upcoming7DaysExcludesWorkerWithFarExpiry — 여유 있으면 제외
• upcoming7DaysIncludesAllExpiryCategories — 5개 카테고리 전부 확인
• upcoming7DaysExcludesAlreadyPastExpiry — 과거 만료일 제외
• 로컬 Demo Seed로 서버 직접 실행, 실제 API 응답으로 검증

참고

이슈: #15
선행PR: #114